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1 .NET Software Development Kit Overview 


This software development kit (SDK) is intended to provide software and Internet 
developers with the ability to integrate postage rate information into programs and/or 
websites. 


1.1 Licenses and Liability 


The information and components contained within this SDK may be distributed only to 
individuals who have signed the USPS User License and may only be used in accordance 
with the terms of the USPS User License. The USPS assumes no liability forthe incorrect 
implementation of this SDK once it has been incorporated into a client product. The 
USPS will supply upgrades to the data and/or the objects when needed, butit assumes 
no part in distribution of these upgrades once the engine has beenintegrated into client 
products. 


1.2 Purpose 


This document isto be used as a supplement to .NET Software Development Kit 
documentation for the Domestic, International and Business Rate Engines. These 
documents are titled as following: 
e NET Software Development Kit (SDK): Developing Applications Using the USPS 
Domestic Retail Rate Engine 
e NET Software Development Kit (SDK): Developing Applications Using the USPS 
International Retail Rate Engine 
e NET Software Development Kit (SDK): Developing Applications Using the USPS 
Domestic Business Rate Engine 


1.3 Contact Information 


For Technical Support, contact: 
Email: RCalcPEPMOSupport@usps.gov 


For USPS Support, contact USPS: 
Email: PostalExplorer@usps.com 


2 Application Programming Interface (API) 
2.1 AdditionallnputValue Class 


2.1.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.1.2 Base Class 


None 


2.1.3 Constructors 
public AdditionallnputValue() 


public AdditionallnputValue(string typelD, decimal enteredValue) 


public AdditionallnputValue(string typelD, string enteredValueString) 


2.1.4 Properties 


Name Type Description 


EnteredValue decimal Gets or sets the value of the 
additional input. 





TypelD string Gets or setsthe type IDto 
identify the additional input 
value. See TypelD table below for 
valid values. 


TypelD 
Name Description 


Declared Value 
Amount to Collection 





2.2 AdditionallnputValueCollection Class 


2.2.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.2.2 Base Class 
List<AdditionallnputValue> 


2.2.3 Properties 


Type Description 
[stringtypelD] decimal Gets or setsthe type idforthe additional input values 
beingaccessed. See TypelD table in the 
AdditionallnputValue section. This allows for member 


of the collection to be access using the following 
notation. 











additional field values["dv"] .EnteredValue 


2.2.4 RemoveType Method 


Description 

This method is used to remove an AdditionallnputValue from the collection. Ifthe 
collections contains an AdditionallnputValue that it’s TypelD matches the passed 
parameter it is removed from the list. If an AdditionallnputValue with the passed 
parameter TypelD is not found the call has no effect. 


Syntax 

publicvoid RemoveType( 
string typelD 

) 


Parameters 

typelD 
Type: string 
Namespace: none 


Return Value 
Type: void 


Example 


AdditionalInputValueCollection additional field values = new 
Additional InputValueCollection () ; 








// add decalred value of 1000 
additional field values.Add(new AdditionalInputValue ("dv", 1000.00)); 
// add amount to collection of 100 
additional field values.Add(new AdditionalInputValue ("ac", 100.00) ); 




















// remove the declared value 
additional field values.RemoveType ("dv") ; 




















2.2.5 UpdatelnputValues Method 


Description 
This method is used to update the additional input values. 


Syntax 
publicvoid UpdatelnputValues(AdditionallnputValue additionallnputValue) 
publicvoid UpdatelnputValues(AdditionallnputValueCollectioninputValues) 


Parameters 
additionallnputValue 
Type: AdditionallnputValue 
Namespace: ManTech.Usps.RateEngine.Entity 


additionallnputValueCollection 
Type: AdditionallnputValueCollection 
Namespace: ManTech.Usps.RateEngine.Entity 


Return Value 
void 


Example 
AdditionalInputValueCollection additional field values = new 
AdditionalInputValueCollection() ; 








// add declared value of 1000 
additional field values.Add(new AdditionalInputValue ("dv", 1000.00)); 
// add amount to collection of 100 
additional field values.Add(new AdditionalInputValue ("ac", 100.00)); 

















// create new collection 
Additional InputValueCollection update additional field values = new 
Additional InputValueCollection () ; 




















// add declared value of 1000 

update additional field values.Add (new AdditionalInputValue ("dv", 
2000.00)); 

// add amount to collection of 100 





update additional field values .Add (new AdditionalInputValue("ac", 
200.00)); 











additional field values.UpdateInputValues (update additional field value 
s); 
Console.WriteLine (additional field values.ToString()); 








2.2.6 ToString Method 


Description 
This method will return a string that contains the AdditionallnputValue as the URL 
parameter list. 


Syntax 
publicstring ToString() 


Parameters 
None 


Return Value 
Type: string 
description 


Example 
AdditionalInputValueCollection additional field values = new 
AdditionalInputValueCollection() ; 








// add decalred value of 1000 

additional field values.Add(new AdditionalInputValue ("dv", 1000.00)); 
// add amount to collection of 100 
additional field values.Add(new AdditionalInputValue ("ac", 100.00) ); 























Console.WriteLine (additional field values.ToString()); 





2.3 Breadcrumb Class 


2.3.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.3.2 Base Class 


None 


2.3.3 Properties 
Name Type 


n 


MailProperties | MailProperties 


2.3.4 PagelD Enumeration 

















Description 
Gets or sets the ID of the page that the breadcrumb 
will be constructed for. See Page/D Enumeration for 
valid values. 
Gets or sets a reference to the MailProperties 
object used to construct the breadcrumb. 

Gets or sets a reference to the MailService object 
used to construct the breadcrumb. 










Name Value Description 


Unknown The ID of the page that the breadcrumb will be constructed 
PE 

MailServices 1 The ID of the page that the breadcrumb will be constructed 
NE 


ExtraServices 2 The ID of the page that the breadcrumb will be constructed 
ue | 
Summary 3 The ID of the page that the breadcrumb will be constructed 
o Am a — | 





2.4 ClientService Class 


2.4.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.4.2 Base Class 


None 


2.4.3 Constructors 


public ClientService() 


2.4.4 Properties 
Name Type 


ClientServicelD | ClientServicelD 
| Clientlype | MailProperties.ClientType 
















Description 
Gets or sets the Client'sID 

Gets or setsthe Client Type 
Gets or setsif the itemis available forthe 
client. 





2.5 ClientServiceCollection Class 


2.5.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.5.2 Base Class 


List<ClientService> 


2.5.3 Constructors 


public ClientServiceCollection() 


2.5.4 FindByClientType Method 


Description 
This method will return the ClientService object of the ClientType. 


Syntax 
public ClientService FindClientType( 
MailProperties.ClientType clientType 


) 


Parameters 
clientType 
Type: MailProperties.ClientType 
Namespace: ManTech.Usps.RateEngine. Entity 


Return Value 
Type: ClientService 
The Client Service object that matches the ClientType 


2.5.5 Contains Method 


Description 
This method is used to check if the list contains a Client Service for the specified 
ClientServicelDand ClientType. 


Syntax 

public bool Contains( 
ClientServicelD clientServicelD, 
MailProperties.ClientType clientType 


Parameters 
clientServicelD 


Type: ClientServicelD 
Namespace: ManTech.Usps.RateEngine. Entity 


clientType 
Type: MailProperties.ClientType 
Namespace: ManTech.Usps.RateEngine. Entity 


Return Value 
Type: bool 


2.6 ClientServicelD Class 


2.6.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.6.2 Base Class 


None 


2.6.3 Constructors 
public ClientServicelD(shortid) 


public ClientServicelD(stringidString) 


2.6.4 Properties 


Name Type Description 


Empty (static) | ClientServicelD | Gets an empty ClientServicelD. 
Gets or sets the value of the ClientServicelD. 





2.6.5 ToShort Method 


Description 
This method returns the client service id as a short. 


Syntax 
publicshort ToShort() 


Parameters 
None 


Return Value 
Type: short 


2.7 ClientServicelDCollection Class 


2.7.1 Namespace 
ManTech.Usps.Rate Engine. Entity 


2.7.2 Base Class 


List<ClientServicelD> 


2.7.3 Constructors 


public ClientServicelDCollection() 


public ClientServicelDCollection(lEnumerable<ClientServicelD> collection) 


2.8 Country Class 


2.8.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.8.2 Base Class 


None 


2.8.3 Constructors 
public Country() 


public Country(CountryID countrylD) 


public Country(string countryName) 


2.8.4 Properties 


Name Type Description 


CountryAliasCollection | Gets the list of aliases for a country. 
Gets or sets the code for the country. 
CountrylD CountrylD Gets or setsthe ID for the country. 


IsDisplayed Gets or setsa flag that indicates ifthe 
AA A 
IsParent Get or setsa flag that indicates if the 
CR | 
MaxWeight Weight Gets or sets the Max Weight for the 
AA ee 


Gets or setsthe Name for the country. 


NameParts string[] Gets or setsan array of name parts for the 
PA ee 
ShowOnlinePrice Gets or setsa flag that indicates if the 
| 


Status CountryStatus Gets or setsthe status of the country. See 
the CountryStatus enumeration for valid 
values. 


TypeOf Gets or setsthe type of country. 





2.8.5 CountryStatus Enumeration 


Name Value Description | 


Unknown [O  |Thestatusofthe country is unknown. 





The status of the country is normal. 


NoOnlineService The status of the country is that there is no online service. 





ServiceSuspended The status of the country is that service is suspended. 


2.9 CountryAlias Class 


2.9.1 Namespace 


ManTech.Usps.RateEngine.International.Entity 


2.9.2 Base Class 


None 


2.9.3 Properties 


Name Type Description 


Gets or setsthe Alias for a country. 


2.10 CountryAliasCollection Class 


2.10.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.10.2 Base Class 


List<CountryAlias> 


2.10.3 Contains Method 


Description 
This methodis used to see if a country's alias is contained within its collection. 


Syntax 
public bool Contains( 
string aliase 


) 


Parameters 

aliase 
Type: string 
Namespace: none 


Return Value 
Type: bool 


2.11 CountryCollection Class 


2.11.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.11.2 Base Class 


List<Country> 


2.11.3 FindByCountrylD Method 


Description 
This method is used to find a country by using the country’s ID. If the country is not 
found the result is null. 


Syntax 
public Country FindByCountrylD( 
CountrylD countryID 


) 


Parameters 
countrylD 
Type: CountryID 
Namespace: ManTech.Usps.RateEngine.International.Entity 


Return Value 
Type: Country 
A reference to the Country object, null if a match was not found. 


2.11.4 FindByCountryName Method 


Description 
This method is used to find a country by using the country’s Name. If the country is not 
found the result is null. 


Syntax 
public Country FindByCountryName( 
string countryName 


) 


Parameters 
countryName 
Type: string 
Namespace: none 


Return Value 
Type: Country 


A reference to the Country object, null if a match was not found. 


Example 


// find the country with the ID of 12000 Alberta (Canada) 
Country country = countries. FindByCountryID(new CountryID(12000) ); 


// find the country with the Name of Alberta (Canada) 
Country country = countries.FindByCountryName ("Alberta (Canada)"); 





2.12 CountryException Class 


2.12.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.12.2 Base Class 


RateEngineException 


2.12.3 Constructors 


public CountryException(stri ng message) 


public CountryException(string message, int errorNumber) 


2.13 CountrylD Class 


2.13.1 Namespace 


ManTech.Usps.RateEngine.International.Entity 


2.13.2 Base Class 


None 


2.13.3 Constructors 
public CountrylD(intid) 


public CountryID(stri ng idString) 


2.13.4 Properties 
Name Type Description 














Empty (static) CountrylD Gets an Empty CountrylD. 
Value int Gets or sets the value of the 





CountrylD. 





2.13.5 Tolnt Method 


Description 
This method returns the country ID as an integer. 


Syntax 
publicint Tolnt() 


Parameters 
None 


Return Value 
Type: int 
The CountrylD represented as an integer. 


2.14 Countrylnformation Class 


2.14.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.14.2 Base Class 


List<CountryInformationltem> 


2.14.3 Constructors 


public CountryInformation(int capacity) 


public Countrylnformation(IEnumerable<Countrylnformationltem> collection) 


2.15 Countrylnformationltem Class 


2.15.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.15.2 Base Class 


List<CountryInformationltem> 


2.15.3 Constructors 


public Countrylnformationltem() 


2.15.4 Properties 
Type Description 


CommercialPlusPrice decimal Gets or sets commercial 
plus price of the mail 
service. 


Country ToExtraServices | CountryToExtraService Collection | Gets a referenceto a 
CountyToExtraService 
collection that contains the 
extra service information. 


Country ToMailService | CountryToMailService Gets a reference to a Mail 
Service object that 
contains the mail service 


information. 
OnlinePrice deci mal Gets or setsthe online 
zz EA OM 
Price decimal Gets or setsthe price of 





2.16 CountryRegulation Class 


2.16.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.16.2 Base Class 


None 


2.16.3 Constructors 
public CountryRegulation() 


2.16.4 Properties 


Name Type Description 


string Gets or sets the additional restrictions. 

Gets or sets a reference to the Country object. 
string | Gets or sets the custom forms. 

Gets or sets the Express Mail notes. 

Gets or sets the Express Mail regulations. 
string | Gets or sets the observations. 

Gets or sets the prohibitions. 

string Gets or sets the restrictions. 


2.17 CountryRegulationCollection Class 


2.17.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.17.2 Base Class 


List<CountryRegulation> 


2.18 CountyToExtraService Class 


2.18.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.18.2 Base Class 


None 


2.18.3 Constructors 
public CountryToExtraService() 


2.18.4 Properties 
Name Type Description 


ExtraServicelD | ExtraServicelD | Gets or sets the ID of the extra service. 


IsAvailable Gets or sets if the extra service is available forthe 
Country. 


Gets or sets the online price of the extra service. 
Gets or setsthe price of the extraservice. 
ServiceTitle Gets or sets the extra service name. 





2.19 CountyToExtraServiceCollection Class 


2.19.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.19.2 Base Class 


List<CountryToExtraService> 


2.19.3 FindByExtraServicelD Method 


Description 
This methodis used to find a CountyToExtraService object by specifying an 
ExtraServicelD. 


Syntax 
public CountyToExtraService FindByExtraServicelD( 
ExtraServicelD id 


) 


Parameters 
id 
Type: ExtraServicelD 
Namespace: ManTech.Usps.RateEngine.Entity 


Return Value 
Type: CountryToExtraService 
A reference to a CountryToExtraService object. 


2.20 CountryToMailService Class 


2.20.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.20.2 Base Class 


None 


2.20.3 Constructors 
public CountryToMailService() 


2.20.4 Properties 


Name Type Description 

DimensionalRange DimensionalRange Gets a reference to a 
DimensionalRange object that 
contains the dimension ranges for 
the mail service. 


EstimatedDeliveryTime | string Gets or setsthe estimated delivery 
InsuranceMax decimal Gets or setsthe maximum allowed 
ee | insurance for the mail service. 
IsAvailable Gets or setsif the extraservice is 
MailServicelD MailServicelD Gets or setsthe ID ofthe mail 


| ServiceTitle | | ServiceTitle  |string Gets or setsthe service name. 
WeightLimit Weight Gets or setsthe maximum weight 
PE A allowed for the mail service. 
WeightLimitOperator | Weight.WeightOperator | Gets or sets the maximum weight 
WeightMin Weight Gets or sets the minimum weight 
A nana allowed for the mail service. 
Gets or sets the minimum weight 
operator. 


[Zone | Gets or sets the country zone 





2.21 CountyToMailServiceCollection Class 


2.21.1 Namespace 
ManTech.Usps.RateEngine.International.Entity 


2.21.2 Base Class 


List<CountryToMailService> 


2.21.3 FindByMailServicelD Method 


Description 
This method is used to find a CountyToMailService object by specifying an 
MailServicelD. 


Syntax 
public CountyToMailService FindByMailServicelD( 
MailServicelD id 


) 


Parameters 
id 
Type: MailServicelD 
Namespace: ManTech.Usps.RateEngine.Entity 


Return Value 
Type: CountryToMailService 
A reference to a CountryToMailService object. 


2.22 Dimension Class 


2.22.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.22.2 Base Class 


None 


2.22.3 Constructors 


public Dimension(decimal dimension) 
public Dimension(string dimensionString) 


2.22.4 Properties 
Name Type Description 


Empty (static) Gets an Empty Dimension. 
Gets or setsthe Value of the dimension. 





2.22.5 ToDecimal Method 


Description 
This method returns the dimension as a decimal. 


Syntax 
public decimal ToDecimal() 


Parameters 
None 


Return Value 
Type: decimal 
The Dimension represented as a deci mal. 


2.22.6 ToString Method 


Description 
This method returns the dimension as a string. 


Syntax 
publicstring ToString() 


Parameters 
None 


Return Value 
Type: string 
The Dimension represented asa string. 


2.23 DimensionalRange Class 


2.23.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.23.2 Base Class 


None 


2.23.3 Properties 


Name Type Description 
AdditionalSizes 


Dimension Gets or sets the maximum length 
+ width+ height. 


Gets or sets the minimum length. 





2.24 DimensionalRangeCollection Class 


2.24.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.24.2 Base Class 


List<DimensionalRange> 


2.25 Dimensions Class 


2.25.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.25.2 Base Class 


None 


2.25.3 Constructors 


public Dimensions() 
public Dimensions(decimal length, decimal width, decimal height) 


public Dimensions(decimal length, decimal width, decimal height, decimal girth, bool 
isRectangular) 


2.25.4 Properties 


Name Type Description 


CubicFeet decimal | Gets the calculated cubic feetfor the supplied 
> a cma 
Cubicinches decimal | Gets the calculated cubic inches for the 
pene | lamen 
DimensionalWeight decimal | Gets the calculated dimensional weight forthe 
A E | 


Gets or setsthe girth of the mail piece. 


GirthFromString string Sets the girth of the mail piece as a string. The 
underlying code will convert the stringto a 
decimal. 

HeightFromString string Sets the height of the mail piece as a string. The 
underlying code will convert the stringto a 
decimal. 

| IsRectangular | bool | Gets or setsif the mail piece is rectangular. — 

IsRectangularFromStri ng string Sets ifthe mail piece is rectangular as string. 
The underlying code will convert the stringto a 
boolean. 

LengthFromString string Sets the length of the mail piece as a string. The 
underlying code will convert the stringto a 
decimal. 


LengthPlusGirth Gets the calculated length plus the girth for the 





| supplied dimensions. 


RoundDownToOuarterlnch Gets or sets if the mail piece needs to be 
rounded down to guarter inch. 


Gets or setsthe width of the mail piece. 


WidthFromString string Sets the width of the mail piece as a string. The 
underlying code will convert the stringto a 
decimal. 





2.25.5 IsZeroed Method 


Description 
This method is to determine if all the dimensions are setto zero. 


Syntax 
Public bool IsZeroed() 


Parameters 
None 


Return Value 
Type: bool 


2.25.6 SetZeroed Method 
Description 
This method is used to set all the dimensions to zero. 


Syntax 
publicvoid SetZeroed() 


Parameters 
None 


Return Value 
Type: void 


2.25.7 IsOversized Method 


Description 
This method is used to determine if the mail piece is oversized. Note all the dimensions 
must be set before calling this method. 


Syntax 


public bool IsOversized() 


public bool IsOversized( 
decimal maxLength, 
decimal maxLenHeightWidth 


) 


public bool IsOversized( 
decimal maxLength, 
decimal maxLenHeightWidth, 
decimal maxLengthPlusGirth 


Parameters 

maxLength 
Type: decimal 
Namespace: none 


maxLenHeightWidth 
Type: decimal 
Namespace: none 


maxLengthPlusGirth 
Type: decimal 
Namespace: none 


Return Value 
Type: bool 


2.25.8 Validate Method 


Description 

This method is used to validate that the supplied are valid. The dimensions will be 
checked to see if any are set to zero, if the dimension if greater the maximum for that 
dimension and if the overall size of the mail piece istoo large. 


Syntax 
publicvoid Validate( 
bool allowOversized 


) 


publicvoid Validate( 
DimensionalRange dimensionalRange, 
bool allowOversized 


Parameters 
dimensionalRange 
Type: DimensionalRange 
Namespace: ManTech.Usps.RateEngine.Entity 


allowOversized 
Type: bool 
Namespace: none 


Return Value 
Type: void 


Exceptions 
Type: DimensionsException 


2.26 ExtraPostageService Class 


For future uses 


2.27 ExtraPostageServiceCollection Class 


For future uses 


2.28 ExtraService Class 


2.28.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.28.2 Base Class 


None 


2.28.3 Properties 


NEME Type Description | 


AdditionalFields AdditionallnputCollection | Gets a collection of additional input 
Category string Gets or sets the category for the 
ClientServicelD ClientServicelD Gets or setsthe ID of the extra 
CommercialPlusPrice | decimal Gets or setsthe commercial plus 
CommercialPlusCost | decimal Gets or setsthe commercial plus cost 
Cost decimal Gets or sets the cost of the extra 


CostString string 
ErrorMessage string Gets or sets an error message if mail 
ErrorNumber int Gets or sets an error number if mail 
HelpLink TextWithLinks 
ExtraServicelD Gets or sets the ID of the extra 
IsAvailable Gets or sets if the extra service is 
IsNSAAvailable Gets or setsif the extraservice is 
IsOnlineAvailable Gets or sets if the extra service is 
NSAPrice decimal Gets or sets the NSA price of the 
NSACost decimal Gets or sets the NSA cost of the extra 
OnlineCost decimal Gets or sets the online cost of the 





OnlineCostString string Gets the online cost as a formatted 
OnlinePrice decimal Gets or sets the online price of the 
OnlinePrice String string Gets the online price as a formatted 
Price decimal Gets or sets the price of the extra 


PriceDetails PriceDetailCollection A collection of price detail fields that 
describe the price for the extra 
PricePrefix string Gets or sets the prefix for the extra 
Gets the price as a formatted string. 
Gets or sets the extra service name. 





2.29 ExtraService.Additionallnput Class 


2.29.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.29.2 Base Class 


None 


2.29.3 Constructors 
public Additionallnput() 


public Additionallnput(string typelD, stri ng label, decimal minValue, decimal maxValue) 


public Additionallnput(string typelD, string label, decimal minValue, decimal maxValue, 
decimal defaultValue) 


2.29.4 Properties 


Name Type Description 


DefaultValue | decimal Gets or sets the default value for this input 
field. 

Footnotes TextWithLinksCollection | Gets a collection of footnotes that specific for 

mp ge 


Gets or sets the label for the input field 


MinValue decimal Gets or sets the minimum value for this input 
field. 

Gets or sets the maximum value for this input 
field. 


TypelD string Gets or sets the type ID to identify the 
additional input value. See TypelD table 
below for valid values. 


TypelD 
NETAS Description 








Declared Value 


Amount to Collection 


2.30 ExtraService.AdditionallnputCollection Class 


2.30.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.30.2 Base Class 


List<ExtraService.Additionallnput> 


2.30.3 Properties 















Description 
[stringtypelD] | Additionallnput | Gets the type ID for the additional input values 
beingaccessed. See TypelD table in the 
AdditionallnputValue section. This allows for 
member of the collection to be access using the 
following notation. 


additional_input["dv"].Label 


2.30.4 FindByTypelD Method 


Description 
This method is used to find an Additionallnput object the matches a specifictype ID. 


Syntax 
public Additionallnput FindByTypelD(stringtypelD) 


Parameters 

typelD 
Type: string 
Namespace: none 


Return Value 
Type: Additionallnput 
A reference to an AdditionalInput object. 


2.31 ExtraServiceCollection Class 


2.31.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.31.2 Base Class 


List<ExtraService> 


2.31.3 FindByExtraServicelD Method 


Description 
This methodis used to find an ExtraService object by specifying a ExtraServicelD. 


Syntax 
public ExtraService FindByExtraServicelD( 
ExtraServicelDid 


) 


Parameters 
id 
Type: ExtraServicelD 
Namespace: ManTech.Usps.RateEngine.Entity 


Return Value 
Type: ExtraService 
A reference to an ExtraService object. 


2.32 ExtraServicelD Class 


2.32.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.32.2 Base Class 


None 


2.32.3 Constructors 
public ExtraServicelD(intid) 


publicExtraServicelD(stringidString) 


2.32.4 Properties 


Name Type Description 


Empty (static) | ExtraServicelD | Gets an empty ExtraServicelD. 





Gets or sets the value of the ExtraServicelD. 


2.32.5 ToLong Method 


Description 
This method returns the extra service id as an integer. 


Syntax 
publicint ToLong() 


Parameters 
None 


Return Value 
Type: int 


2.33 ExtraServicelDCollection Class 


2.33.1 Namespace 
ManTech.Usps.Rate Engine. Entity 


2.33.2 Base Class 


List<ExtraServicelD> 


2.33.3 Constructors 


public ExtraServicelDCollection() 


public ExtraServicelDCollection(stringids) 


2.33.4 Exists Method 


Description 
This method is used to determine if the collection contains a specified extra service ID. 


Syntax 
public bool Exist( 
ExtraServicelDextraServicelD 


) 


Parameters 
extraServicelD 
Type: ExtraServicelD 
Namespace: ManTech.Usps.RateEngine.Entity 


Return Value 
Type: bool 


2.33.5 AddExclusive Method 


Description 

This method is used to add a extra service ID to the collection if the collection doesn't 
already contain the specified extra service ID. If the specified extra service ID is already 
in the collection the collection will remain unchanged. 


Syntax 
publicvoid AddExclusive( 
ExtraServicelD extraServicelD 


) 


Parameters 


extraServicelD 
Type: ExtraServicelD 
Namespace: ManTech.Usps.RateEngine.Entity 


Return Value 
Type: void 


2.33.6 RemoveByld Method 


Description 

This method is used to remove a specified extra service ID from the collection. If the 
collection does not contain the specified extra service ID the collection will remain 
unchanged. The method returns true if the id was found and removed and false if the id 
was not found. 


Syntax 
publicbool RemoveByld( 
ExtraServicelDextraServicelD 


) 


Parameters 
extraServicelD 
Type: ExtraServicelD 
Namespace: ManTech.Usps.RateEngine.Entity 


Return Value 
Type: bool 


2.33.7 ToString Method 


Description 
This return value of this method contains a comma delineated stringthat contains all of 
the extra service IDs containedin the collection. 


Syntax 
publicstring ToString() 


Parameters 
None 


Return Value 
Type: string 


2.34 Link Class 


2.34.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.34.2 Base Class 


None 


2.34.3 Properties 


Name Type Description 
Gets or sets the cascading style sheet class for the web tag. 
[id [shot | Gets or sets the ID of the link. 
Gets or sets the style for the web tag. 
Gets or sets the web target. 
string Gets or sets the text for the link. 
Gets or sets the web navigation URL. 
Gets or sets the windows navigation URL. 


2.35 GXGLocation Class 


2.35.1 Namespace 
ManTech.Usps.RateEngine.International.Retail.Entity 


2.35.2 Base Class 


None 


2.35.3 Properties 


Name Type Description 


Gets or sets the City address for the location. 

Gets or sets the Location Name. 

Gets or sets the Saturday Cutoff time for the location. 
Gets or sets the State address for the location. 

Gets or sets the Street address for the location. 

Gets or sets the Weekday Cutoff time for the location. 
Gets or sets the ZIP Code address for the location. 


2.36 GXGLocationCollection Class 


2.36.1 Namespace 
ManTech.Usps.RateEngine.International.Retail.Entity 


2.36.2 Base Class 
List<GXGLocation> 


2.36.3 ContainsZIPCode Method 


Description 
This method is used to validate ifthe length plus girth iswithinthe maximum for a 
Global Express Guaranteed package. 


Syntax 
public bool ContainsZIPCode (ZipCode zipCode) 


Parameters 

zipCode 
Type: ZipCode 
Namespace: none 


Return Value 
Type: bool 


2.37 


2.38 LinkCollection Class 


2.38.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.38.2 Base Class 
List<Link> 


2.39 Location Class 


2.39.1 Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


2.39.2 Base Class 


None 


2.39.3 Constructors 


public Location() 


public Location(string zip, string financeCode, string city, string state, string 
classificationCode, TypeOfLocation locationType) 


public Location(ZipCode zip, string financeCode, string city, string state, string 
classificationCode, TypeOfLocation locationType) 


public Location(ZipCode zipCode, TypeOfLocation locationType, bool isValid) 


public Location(Location fromLocation) 


2.39.4 Properties 


Name Type Description 


Gets or sets the City for this location. 


ClassificationCode string Gets or sets the Classification Code for 
this location. 

FincanceCode string Gets or sets the Finance Code for this 
location. 


sapo [Boo | Gets ifthe location is an APO/FPO/DPO 


IsHoldForPickupAvailable Gets or sets if hold for pickup is 
available. 


IsMailable | bool | Gets if the location can be mailed to. 


IsSundayHolidayAvailable Gets or sets if Sunday or holiday is 
available. 


vaia | bool [Gets or setsifthisisa validlocation. | 





ZipCode ZipCode Gets or sets the ZIP Code for this 
location. 


2.39.5 Validate Method 


Description 
This method is used to determine if this is a valid location. 


Syntax 
publicvoid Validate() 


Parameters 
None 


Return Value 
Type: void 


Exceptions 
Type: LocationException 


2.40 LocationCollection Class 


2.40.1 Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


2.40.2 Base Class 


List<Location> 


2.41 MailProperties Class 


2.41.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.41.2 Base Class 


None 


2.41.3 Properties 


Name Type Description 

AdditionalExtraService | AdditionallnputValue Gets a reference to the 

InputValues Collection AdditionalnputValue Collection 
object. 

CharacteristicsID Gets or sets the characteristics ID. 


This id is used to specify mail 
characteristics such as ridged or odd 
shaped. See the Characteristics 
table for valid values for this field. 
Client ClientType Gets or sets the Type of Client 
making the class to the rate engine. 
See the ClientType enumerator for 
valid values for the field. 
ClientMailServicelD ClientServicelD Gets or setsthe ClientMailServicelD. 
The ClientMailServicelDisthe ID 
known by the Client. 
ClientServicelDCollection | Gets a reference to a collection that 
contains the Client Extra Service ID 
of selected Extra Services. The 
ExtraServicelDis the ID known by 








ClientExtraServicelDs 


the Client 
Dimensions Dimensions Gets or setsa referenceto a 
Dimensions object. 


ExtraServices ExtraServicelDCollection | Gets a reference to a collection that 


contains the Extra Service ID of 
selected Extra Services. 
MailShapeAndSizeEnum | Gets or setsthe mail piece shape 





MailShapeAndSize 





and size. See the 
MailShapeAndSizeEnum for valid 


values for this field. 


MailShapeAndSize string Gets or setsthe mail piece shape 
String and size as a string. 


MailServicelD MailServicelD Gets or setsthe MailServicelD. The 


MailServicelDis used to specify the 
selected Mail Service. 





Weight Weight Gets or setsa reference to a Weight 
object. 


2.41.4 GetDimensionShapeAndSize Method 


Description 
This method is used to determine the mail piece shape and size based on the 
dimensions provided. 


Syntax 
public MailShapeAndSizeEnum GetDimensionShapeAndSize() 


Parameters 
None 


Return Value 
Type: MailShapeAndSizeEnum 


2.41.5 Characteristics Table 


Mail Shape and Size Characteristics ID Reason 


0 [Machinable | 
fietterlarge | o [Machinble O 
Non-Machinable 


2.41.6 ClientType Enumeration 





Name Value Description 


| Unknown lo | The system being used client type isunknown. 


[CARS — [6 — The system being used dienttype is CARS — ——— 
[ons —— 5 — The system being used cienttype is 0nS —— — — 





| CnSBusiness |9 | Not currently defined 


PCPostage Not currently defined 
PASS Not currently defined 





2.42 MailingRestriction Class 


2.42.1 Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


2.42.2 Base Class 


None 


2.42.3 Constructors 
public MailingRestriction() 


public MailingRestriction(ZipCode zipCode) 


2.42.4 Properties 


Name Type Description 


Restrictions | RestrictionCollection | Gets or setsa reference to a collection of mailing 
restrictions. 





ZipCode ZipCode Gets or sets the ZIP Code for the mailing 
restrictions. 


2.43 MailingRestriction.Restriction Class 


2.43.1 Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


2.43.2 Base Class 


None 


2.43.3 Constructors 
public Restriction() 


public Restriction(string code) 


2.43.4 Properties 














Name Type 


Description 
Gets or sets the code for the mailing restriction. 
Gets or sets the description of the mailing restriction. 





2.44 MailingRestriction.RestrictionCollection Class 


2.44.1 Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


2.44.2 Base Class 


List<MailingRestriction.Restriction> 


2.45 MailingRestrictionCollection Class 


2.45.1 Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


2.45.2 Base Class 


List<MailingRestriction> 


2.46 MailService Class 


2.46.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.46.2 Base Class 


None 


2.46.3 Properties 


Description 
ClientServicelD ClientServicelD Gets or setsthe mail service ID 
known by the client. 


CommercialPlusPrice decimal Gets or sets commercial plus 
K A IT | 
CommercialPlusPriceString | string Gets the mail service commercial 
A a 


DimensionalRange DimensionalRange Gets a referenceto a 
DimensionalRange objectthat 


contains the dimension ranges 
forthe mail service. 


ErrorMessage string Gets or setsan error message. 
ErrorNumber Gets or setsan error number. 


EstimatedDeliveryTime string Gets or setsthe estimated 
delivery time. 


Hel pLink TextWithLinks Gets a referenceto a 


TextWithLinks object that 
contains the helplink 
information. 


a |MailServicelD Gets or setsthe mail service ID. 


Includedindemnity decimal Gets or sets the insurance 
es indemnity allowed for the mail 
service. 
InsuranceMax decimal Gets or setsthe maximum 
o ail allowed insurance for the mail 
service. 


IsAvailable Gets or sets if the extra service is 
available to retail. 

IsNSAAvailable Gets or setsif the extraservice is 
available to NSA. 

IsOnlineAvailable Gets or sets if the extraservice is 
available to online. 





MaxWeight Weight Gets or setsthe maximum 

weight allowed for the mail 
MinWeight Weight Gets or setsthe minimum 

service. 
Notes TextWithLinksCollection | Gets a reference to a Collection 

of TextWithLinks object that 
MES contains the note information. 
NSAPrice decimal Gets or setsthe NSA price ofthe 
| 
OnlinePrice decimal Gets or sets the online price of 
pan 
OnlinePriceString string Gets the mail service online 
E EA earner: | 


OnlinePriceTextWithLinks | TextWithLinks Gets the mail service online 
EE 
Orderlndex int Gets or setsthe value used to 
S ee 
Price decimal Gets or setsthe price of the mail 
PL A + ad 
PriceDetails PriceDetailCollection Gets a reference to a Collection 
of PriceDetail objectthat 
MN contains the pricinginformation. 
PriceLink TextWithLinks Gets or setsa link associated 
S O MA 
PriceString string Gets the mail service price as a 
oa ie 1 


PriceTextWithLinks TextWithLinks Gets the mail service price as a 
TextWithLinks object 


ServiceName string Gets or sets the service name. 





2.47 MailServiceCollection Class 


2.47.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.47.2 Base Class 


List<MailService> 


2.47.3 FindByMailServicelD 


Description 
This method is used to find a MailService object by specifying a MailServicelD. 


Syntax 
public MailService FindByMailServicelD( 
MailServicelD mailServicelD 


) 


Parameters 
mailServicelD 
Type: MailServicelD 
Namespace: ManTech.Usps.RateEngine.Entity 


Return Value 

Type: MailService 

A reference to the Mail Service found for the specified MailService ID. Nullis returned if 
no mail service is found. 


2.48 MailServicelD Class 


2.48.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.48.2 Base Class 


None 


2.48.3 Constructors 
public MailServicelD(shortid) 


public MailServicelD(string idString) 


2.48.4 Properties 


Name Type Description 


Empty (static) | MailServicelD | Gets an empty MailServicelD. 
Gets or sets the value of the MailServicelD. 





2.48.5 ToShort Method 


Description 
This method returns the mail service ID as an integer. 


Syntax 
publicshort ToShort() 


Parameters 
None 


Return Value 
Type: short 


2.49 MailServicelDCollection Class 


2.49.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.49.2 Base Class 


List<MailServicelD> 


2.50 MailShapeAndSizeEnum Enumerator 


2.50.1 Namespace 
ManTech.Usps.Rate Engine. Entity 


2.50.2 MailShapeAndSizeEnum Enumerator 


Name Value Description 

Undefined 0. | The mail piece Shape and Size is unknown. 
Letter The mail piece is a letter. 

LetterLarge The mail piece is a large letter. 

Package |6 |The mail piece is a package. 


The mail piece is a large package. 
RE CST e 
| Postcardlarge  |9 | The mail pieceis a large postcard. | 


The mail piece is an Priority Mail. 





jecei 
¡ 
jecei 
jecei 
jecei 
jecei 
i 
jecei 
jecei 
jecei 


2.51 PostageAttribute Class 


For future uses 


2.52 PostageAttributeCollection Class 


For future uses 


2.53 PostagePrice Class 


For future uses 


2.54 PostagePriceCollection Class 
For future uses 


2.55 PostageService Class 


For future uses 


2.56 PostageServiceCollection Class 


For future uses 


2.57 PriceDetail Class 


2.57.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.57.2 Base Class 


None 


2.57.3 Constructors 
public Price Detail() 


public Price Detail(string key, string value) 


2.57.4 Properties 


Name Type Description 


Key string Gets or sets the key 
for the price detail. 





Value string Gets or sets the value 
for the price detail. 


2.58 PriceDetailCollection 


2.58.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.58.2 Base Class 
List<Price Detail> 


2.58.3 Constructors 
public PriceDetailCollection() 


public PriceDetailCollection(IEnumerable<Price Detail> collection) 


2.58.4 Properties 






Name Type Description 


[string key] Gets or sets the key for the price detail. 


2.59 ResultSection Class 


For future uses 


2.60 ResultSectionCollection Class 


For future uses 


2.61 SummaryCollection Class 


2.61.1 Namespace 
ManTech.Usps.Rate Engine. Entity 


2.61.2 Base Class 


List<Summaryltem> 


2.62 Summaryltem Class 


2.62.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.62.2 Base Class 


None 


2.62.3 Properties 


Name Type Description 


CommercialPlusCost Gets or sets the commercial plus cost of the service 
Cost Gets or sets the cost of the service 


IsAvailable 


CostString Gets the cost ofthe service as a formatted string. 


Gets or setsa flag that indicates ifthe retail cost is 
available. 


OnlineCost decimal Gets or setsthe online cost of the service 


OnlineCostString Gets the online cost of the service as a formatted 
string. 


IsOnlineAvailable Gets or setsa flag that indicates if the online cost is 
available 

ServiceName string Gets or setsthe name of the service. This can be a 
mail service or extra service. 





2.63 TextWithLinks Class 


2.63.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.63.2 Base Class 


None 


2.63.3 Properties 



















Name Type Description 


Gets or sets the cascading style sheet class for the web tag. 


Gets or sets the ID of the TextWithLinks object. 


Links LinkCollection | Gets or setsa reference to a collection of links that are 
associated with that object. 


Gets or sets the text to be displayed. 









2.64 TextWithLinksCollection Class 


2.64.1 Namespace 
ManTech.Usps.Rate Engine. Entity 


2.64.2 Base Class 
List<TextWithLinks> 


2.64.3 AddLinkTo Method 
Description 


This method is used to add a link to a TextWithLinks object. 


Syntax 
publicvoid AddLinkTo( 
Link link, 
intid 
) 
Parameters 
link 
Type: Link 
Namespace: ManTech.Usps.RateEngine.Entity 


Type: int 
Namespace: none 
Return Value 


Type: void 


2.64.4 RemoveByiD Method 
Description 


This method is used to remove a link from the TextWithLinks object by specifying an ID. 


Syntax 

publicvoid RemoveByiID( 
short id 

) 


Parameters 
id 


Type: short 
Namespace: none 


Return Value 
Type: void 


2.64.5 FindByID Method 


Description 
This method is used to finda link from the TextWithLinks object by specifying an|ID and 
returninga TextWithLinks objectif found. 


Syntax 

public TextWithLinks FindByID( 
short id 

) 


Parameters 

id 
Type: short 
Namespace: none 


Return Value 
Type: TextWithLinks 


2.64.6 ContainsID Method 


Description 
This method is used to determine if the TextWithLinks object exists by specifying an ID. 


Syntax 

public bool Contains! D( 
shortid 

) 


Parameters 

id 
Type: short 
Namespace: none 


Return Value 
Type: bool 


2.65 Weight Class 


2.65.1 Namespace 
ManTech.Usps.RateEngine.Entity 


2.65.2 Base Class 


None 


2.65.3 Constructors 
public Weight() 


public Weight(decimal ounces, decimal pounds) 


2.65.4 Properties 


Name Type Description 
Gets or sets the ounces. 


OuncesFromString | string Sets the ounces with a string value. The string will 
be converted to a decimal. If the string is invalid an 
exception of type WeightException is thrown. 

Gets or sets the pounds. 

PoundsFromString | string Sets the pounds with a string value. The string will 
be converted to a decimal. If the string is invalid an 
exception of type WeightException is thrown. 
Units WeightUnit | Gets or sets default units to be used when calling 

weight methods. See the WeightUnit enumeration 
for valid values. 








2.65.5 WeightUnit Enumeration 


Name Value Description 


| Unknown [O  |Theweightunitof measurement to be used is unknown. 
The weight unit of measurement to be used is ounces. 
The weight unit of measurementto be used is pounds. 


2.65.6 WeightOperator Enumeration 





Name Value Description 


| Unknown [O | The weightoperator to be used isunknown. 
The weight operator to be used is ‘<. 


LessOrEqual The weight operator to be used is “<= 


GreatOrEqual The weight operator to be used is ‘>= 


3 The weight operator to be used is ‘=’. 
The weight operator to be used is ‘>’. 





2.65.7 ToPounds Method 


Description 
This method is used to get the weight represented as the whole and factional pounds 
value. Note both the ounces and pounds fields are returned as a pounds value. 


Syntax 
public decimal ToPounds() 


Parameters 
None 


Return Value 
Type: decimal 


Example 





Weight mail weight = new Weight(4, 2); 
Console.WriteLine (mail weight. ToPounds ()); 





Example Output 


2229 


2.65.8 ToOunces Method 


Description 
This method is used to get the weight represented as the whole and factional ounces 
value. Note both the ounces and pounds fields are returned as an ounces value. 


Syntax 
public decimal ToOunces() 


Parameters 
None 


Return Value 
Type: decimal 
description 


Example 


Weight mail weight = new Weight(4, 2); 
Console.WriteLine (mail weight. ToOunces ()); 








Example Output 


36 


2.65.9 ToString Method 


Description 

This method is used to get the weightas a string value. The Units field will affect the 
returned value. If the Units are set to WeightUnit.Ounces the string is formatted as the 
amount of ounces contained with the weight object, if the Units are set to 
WeightUnit.Pounds the string is formatted as the amount of pounds contained with the 
weight object. 


Syntax 
publicstring ToString() 


Parameters 
None 


Return Value 
Type: string 


2.65.10 ToPoundsOuncesString Method 


Description 
This method is used to get the weight as string value that displays the whole pounds and 
ounces. 


Example: 
If the pounds are set to 2.5 and the ounces are set to 6; the string returned will read: 
“3 pounds O ounces” 


If the pounds are set to 2 and the ouncesare setto 24; the string return will read: 
“3 pounds 6 ounces” 


Syntax 
publicstring ToPoundsOuncesString() 


Parameters 
None 


Return Value 
Type: string 


2.66 ZipCode Class 


2.66.1 Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


2.66.2 Base Class 


None 


2.66.3 Constructors 
ZipCode(string zip) 


2.66.4 Properties 


Name Type Description 
IsDepartmentOfHomelandSecurity Gets a flag that indicates ifthe ZIP Code 
is one of the Department of Homeland 
Security ZIP Codes 
IsDestinationOnly Gets a flag that indicates ifthe ZIP Code 
eo Stones destnaonani ode — 


IsExtendedStateDepartment Gets a flag that indicates ifthe ZIP Code 


is one of the Extended State 
Department ZIP Codes. 

IsStateDepartment Gets a flagthat indicates ifthe ZIP Code 
is one of the State Department ZIP 
Codes. 


IsOffShore Gets a flag that indicates ifthe ZIP Code 
is one of the offshore ZIP Codes. 
Gets or sets the Value of the ZIP Code. 


NOTE: To create a zip code using 3 digits, enter underscores (‘_’) for the last 2 digits. 





2.66.5 ToString3Digit Method 


Description 
This method is used to get the sub 3 digit ZIP Code. 


Syntax 
publicstring ToString3Digit() 


Parameters 
None 


Return Value 
Type: string 


2.67 ZipCodeCollection Class 


2.67.1 Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


2.67.2 Base Class 
List<ZipCode> 


2.67.3 Constructors 
public ZipCodeCollection() 


public ZipCodeCollection(IEnumerable<ZipCode>zipCodes) 


2.67.4 ContainsZipCode Method 


Description 
This method is used to determine if the collection already contains the zip code. 


Syntax 

public bool ContainsZIPCode( 
ZipCode zipCode 

) 


Parameters 
zipCode 
Type: ZipCode 
NameSpace: ManTech.Usps.RateEngine.Entity 


Return Value 
Type: bool 


2.68 Zone Class 


2.68.1 Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


2.68.2 Base Class 


None 


2.68.3 Constructors 
publicZone() 


publicZone(ZipCode originZipCode, ZipCode destinationZipCode, int zoneCount, bool 
isIntraBMC, bool isLocal) 


2.68.4 Properties 


Name Type Description 


DestinationZipCode | ZipCode | Gets or sets the destination ZIP Code. 


IsintraBMC PE Gets or sets a flag that indicates ifthe zone isintra 
BMC. 


| Islocal [bool | Gets or sets a flag that indicates ifthe zone is local. 
OriginZipCode ZipCode | Gets or sets the origin ZIP Code. 





2.69 ZoneCollection Class 


2.69.1 Namespace 
ManTech.Usps.RateEngine.Domestic.Entity 


2.69.2 Base Class 


List<Zone> 
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